home *** CD-ROM | disk | FTP | other *** search
/ Internet Cyber Guide 2 / Internet Cyber Guide 02.iso / PlaNETpc / kit95 / archie / wsarch32.txt next >
Encoding:
Text File  |  1996-08-29  |  12.3 KB  |  297 lines
  1. WSArchie Alpha Version 07-09-1996 for Win95/NT
  2. ==============================================
  3. This client is a first stab at a win32 archie client.  It requires
  4. Windows 95 or Windows NT 3.51 to run as the query is a thread and 
  5. it uses Tree and List views.
  6.  
  7. To use it all you need to do is run the program.
  8.  
  9. New Features:
  10.  
  11. 1. Filter Using Path.  If this box is filled in then the archie
  12.    search will be restricted to directories containing the string.
  13.    eg:
  14.  
  15.    Path - "winsock"
  16.    Search for - "wsarchie.zip"
  17.  
  18. 2. Wsarchie can now retrieve useing a browser.  No need to specify
  19.    a path or executable simply tick the box "Use Web Browser" and
  20.    when you retrieve a file the default Web Browser should be kicked
  21.    off and the file retrieved.  This might also work if a gopher
  22.    site was what was found.  I haven't been able to test this.
  23.    Obviously this feature depends on having a Web Browser like
  24.    Microsoft's Internet Explorer or Netscape Navigator installed.
  25.  
  26. 3. The edit menu items are implemented.  They work on items listed
  27.    in the lower window.  I'm not completely happy with this 
  28.    arrangement, but that's how it's done for now.
  29.    NB There are context menus for both lower boxes (use that right 
  30.    mouse button!).
  31.  
  32. 4. Matches:  Three parameters can be specified to restrict matches,
  33.    I quote the archie manual page:
  34.  
  35.      Max Hits
  36.           Allow the find command to generate at most  the  speci-
  37.           fied  number  of  matches  (permissible  range: 0-1000;
  38.           default: 10).
  39.  
  40.      Max Hits per Match
  41.           Across all the anonymous FTP archives on  the  Internet
  42.           (and  even  on  one  single anonymous FTP archive) many
  43.           files will have the same  name.  For  example,  if  you
  44.           search for a very common filename like "README" you can
  45.           get hundreds even thousands of matches. You  can  limit
  46.           the  number  of  files  with the same name through this
  47.           variable. For example a value of 100 tells  the  system
  48.           only 100 files  with  the  same  name.
  49.           Note  that the overall maximum number of files returned
  50.           is still controlled with the 'Max Hits' variable.
  51.  
  52.      Max Match
  53.           This variable will limit the number filenames returned.
  54.           For  example, if Max Match is set to 2 and you perform a
  55.           substring search for the string "etc", and the  catalog
  56.           contains  filenames  "etca", "betc" and "detc" only the
  57.           filenames "etca" and "betc" will be returned.  However,
  58.           depending  on  the  values of maxhitspm and maxhits you
  59.           will get back a  number  of  actual  files  with  those
  60.           names.
  61.  
  62. And that's it for now.  Help is not yet fully implemented, I will
  63. work on this soon.  An Uninstall facility (as if you would want 
  64. to...) is also on the cards, as well as outputing results as they
  65. arrive.
  66.  
  67.  
  68. Support for FTP clients is still there.  Enter the FTP setup 
  69. dialog and make sure that you enter the full path and name of 
  70. the FTP program you use. 
  71.  
  72. The command line parameters are now in a seperate box but they still
  73. work the same way, namely with substitution strings.
  74.  
  75. Where the existing directory which holds ws_ftp32.exe is d:\ws_ftp,
  76. and where the existing directory for the to be received files is 
  77. ws_ftp\newfiles, in the Option->Ftp Setup, you would use the 
  78. following for the Command:
  79.     
  80. d:\ws_ftp\ws_ftp32 
  81.  
  82. and the following for the Parameters:
  83.  
  84. //%h/%d/%f local:d:\ws_ftp\newfiles\%f
  85.  
  86. %h will be substituted with the host name
  87. %d will be substituted with the remote directory name
  88. %f will be substituted with the remote filename.
  89.  
  90. If you had it configured and working before, tough luck you will
  91. need to split the command and the parameters as I was too lazy
  92. to make the program work it out for itself.
  93.  
  94. Directory expansion is now possible, probably best done with the right mouse
  95. button after selecting the directory that you wish to expand.
  96.  
  97. The help file is not yet complete.  This will be improved over time.
  98.  
  99. Try it out and let me know how you get on via email or my WWW page
  100.  
  101. http://dspace.dial.pipex.com/david.woakes/
  102.  
  103. This archie client is based upon the archie client that is included in the
  104. Prospero V5.1a release.
  105.  
  106. It was written by Clifford Neuman with changes by Brendan Kehoe
  107. and George Ferguson.
  108.  
  109. If you want to know more about Prospero send an email message to 
  110. info-prospero@isi.edu.  Do not send questions about WSARCHIE to
  111. this address, send them to david.woakes@dial.pipex.com, PLEASE.
  112.  
  113. Keep an eye on my WWW home page for latest releases:
  114.  
  115. http://dspace.dial.pipex.com/town/square/cc83/
  116.  
  117.  
  118. Installation.
  119. =============
  120.  
  121. This instructions assume that you have some form of WINSOCK
  122. installed and working.
  123.  
  124. 1. Unzip wsarch32.zip in a directory by itself. There should be two
  125. files altogether:
  126.  
  127. wsarch32.exe    - this is the program itself.
  128. wsarch32.txt    - this file
  129.  
  130. Thats it.
  131.  
  132. To use, enter your search term in the "Search for" field, and then
  133. press return, or select the Search button.
  134.  
  135. At the moment you wont see anything about how your query is 
  136. progressing until either it completes or times out, and no error 
  137. message is returned in the latter case!  These things will be added 
  138. in time, I just wanted to get something out before I go away for 
  139. Christmas!  I will be refining and adding functionality then.
  140.  
  141. Regards
  142. David Woakes
  143.  
  144. ----------------------------------------------------------------
  145.  
  146. Currently this version of WSARCHIE may not be distributed or placed
  147. on FTP sites. This is because it is strictly speaking an ALPHA test
  148. release.
  149.  
  150. The address to send your donation to is:
  151.  
  152. David Woakes
  153. 88 Spottiswoode St
  154. Edinburgh
  155. EH9 1DJ
  156.  
  157. I attach a copy of the latest licensing agreement from the University of
  158. Southern California:
  159.  
  160. /* 
  161.  *  Copyright (c) 1991-1994 by the University of Southern California
  162.  *  All rights reserved.
  163.  *
  164.  *  PROSPERO(TM) LICENSE AGREEMENT
  165.  *
  166.  * 1. COPYRIGHT.  The Prospero software is owned by the University of
  167.  *    Southern California and is protected by the United States copyright 
  168.  *    laws and international treaty provisions.  Other copyrights may
  169.  *    apply to parts of the Prospero distribution and are so noted when
  170.  *    known to be applicable.
  171.  * 
  172.  * 2. DISCLAIMER OF WARRANTY.  THIS SOFTWARE IS PROVIDED "AS IS".  The
  173.  *    University of Southern California MAKES NO REPRESENTATIONS OR
  174.  *    WARRANTIES, EXPRESS OR IMPLIED.  By way of example, but not
  175.  *    limitation, the University of Southern California MAKES NO
  176.  *    REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY
  177.  *    PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE
  178.  *    COMPONENTS OR DOCUMENTATION WILL NOT INFRINGE ANY PATENTS,
  179.  *    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.  The University of Southern
  180.  *    California shall not be held liable for any liability nor for any
  181.  *    direct, indirect, or consequential damages with respect to any
  182.  *    claim by the user or distributor of the Prospero software or any
  183.  *    third party on account of or arising from this Agreement or the use
  184.  *    or distribution of the Prospero software. 
  185.  * 
  186.  * 3. GRANT OF LICENSE.
  187.  * 
  188.  *  a) Permission to use, copy, modify, and distribute this software and
  189.  *     its documentation in source and binary forms is hereby granted,
  190.  *     provided that:
  191.  * 
  192.  *       i) the use, copying, or distribution is not done for direct
  193.  *          commercial advantage;
  194.  * 
  195.  *      ii) any distribution of the software is on the same terms as in
  196.  *          this Prospero License Agreement, and each copy contains the
  197.  *          copyright notices and the license agreement that appear in
  198.  *          this software and supporting documentation; and  
  199.  * 
  200.  *     iii) any documentation or other materials related to such
  201.  *          distribution or use acknowledge that the software was developed
  202.  *          by the University of Southern California.  
  203.  * 
  204.  *  b) Permission to copy, modify, and distribute this software and its
  205.  *     documentation in source and binary forms AS PART OF ANOTHER
  206.  *     PRODUCT for commercial advantage is hereby granted, provided that:
  207.  * 
  208.  *       i) notice is provided to the University of Southern California
  209.  *          describing the use of Prospero in the product;    
  210.  * 
  211.  *      ii) any distribution of the software is on the same terms as in
  212.  *          this Prospero License Agreement, and those terms apply also to
  213.  *          the distribution and use of that part of the product derived
  214.  *          from the Prospero distribution (it is acceptable to
  215.  *          impose additional restrictions on other parts of the product), 
  216.  *          and each copy contains the copyright notices and the license
  217.  *          agreement that appear in this software and supporting
  218.  *          documentation; 
  219.  * 
  220.  *     iii) any documentation or other materials related to such
  221.  *          distribution or use acknowledge that the software was developed
  222.  *          by the University of Southern California; and
  223.  * 
  224.  *      iv) one of the following three conditions is met:
  225.  * 
  226.  *          a. The product so distributed has been developed
  227.  *             independently and it incorporates only files and related
  228.  *             functions (e.g. allocators) from the Prospero distribution
  229.  *             needed to providing compatibility with the Prospero
  230.  *             distribution; or  
  231.  * 
  232.  *          b. the product so distributed has been developed independently
  233.  *             and the parts of the Prospero distribution included
  234.  *             constitute less than 25% of the product, and the total annual
  235.  *             sales of products incorporating Prospero does not exceed
  236.  *             $100,000 (U.S. Dollars); or
  237.  * 
  238.  *          c. parties to which the product is sold or distributed are
  239.  *             allowed to use or distribute the product in source and binary
  240.  *             forms without fee if the party's use or distribution of the
  241.  *             product is not for direct commercial advantage. 
  242.  * 
  243.  *  c) Permission to use this software to provide a service for a fee is
  244.  *     granted provided that notice is provided to the University of
  245.  *     Southern California describing the nature of the service and
  246.  *     provided that the total annual revenues for the service provided
  247.  *     using Prospero does not exceed $250,000 (U.S. dollars).
  248.  * 
  249.  *  d) Any use, copying, modification, or distribution other than as
  250.  *     provided for above requires an additional license from the
  251.  *     University of Southern California.  The University of Southern
  252.  *     California is prepared to license this software for such use on
  253.  *     reasonable terms.  
  254.  * 
  255.  * 4. OTHER RESTRICTIONS.  Nothing in this Agreement shall be construed
  256.  *    as conferring rights to use in advertising, publicity, or
  257.  *    otherwise, the name of the University of Southern California, or
  258.  *    any trademark thereof. 
  259.  * 
  260.  *   This agreement shall be construed, interpreted, and applied in
  261.  *   accordance with the laws of the State of California, United States of
  262.  *   America.  If any part of this Agreement is held illegal or
  263.  *   unenforceable, the remaining portions shall not be affected.
  264.  * 
  265.  *   Any notice required under this agreement shall be sent to the Prospero
  266.  *   Project; Information Sciences Institute; University of Southern
  267.  *   California; 4676 Admiralty Way; Marina del Rey, California 90292-6695
  268.  *   USA. Any questions concerning the Prospero distribution should be
  269.  *   directed to info-prospero@isi.edu.
  270.  * 
  271.  *   Prospero was originally written by Clifford Neuman (bcn@isi.edu) while
  272.  *   a graduate student at the University of Washington, and subsequently at
  273.  *   the Information Sciences Institute of the University of Southern
  274.  *   California.  Contributors include Steven Seger Augart (swa@isi.edu),
  275.  *   Santosh Rao (srao@isi.edu), and other individuals identified in the
  276.  *   software distribution and accompanying documentation.
  277.  * 
  278.  *   Prospero, the Prospero Directory Service, the Prospero File System, 
  279.  *   and the Prospero Resource Manager are trademarks of the 
  280.  *   University of Southern California. 
  281.  * 
  282.  */
  283.  
  284. Release History
  285. ---------------
  286.  
  287. 1995.12.21
  288.  
  289. 1st release. No FTP support or domain support. Also no feedback
  290. on progress of query.
  291.  
  292. 1996.01.21
  293.  
  294. 2nd Release. No FTP support.
  295. Added support for domain option and also give feedback on
  296. progress.
  297.